home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / libblas / spmv.z / spmv
Encoding:
Text File  |  2002-10-03  |  4.0 KB  |  101 lines
  1. SPMV(3F)                                              Last changed: 11-2-98
  2.  
  3.  
  4. NNAAMMEE
  5.      SSSSPPMMVV, DDSSPPMMVV - Multiplies a real or complex symmetric packed matrix by
  6.      a real or complex vector
  7.  
  8. SSYYNNOOPPSSIISS
  9.      Real
  10.  
  11.         CCAALLLL SSSSPPMMVV ((_u_p_l_o,, _n,, _a_l_p_h_a,, _a_p,, _x,, _i_n_c_x,, _b_e_t_a,, _y,, _i_n_c_y))
  12.  
  13.      Double precision
  14.  
  15.         CCAALLLL DDSSPPMMVV ((_u_p_l_o,, _n,, _a_l_p_h_a,, _a_p,, _x,, _i_n_c_x,, _b_e_t_a,, _y,, _i_n_c_y))
  16.  
  17. IIMMPPLLEEMMEENNTTAATTIIOONN
  18.      IRIX systems
  19.  
  20. DDEESSCCRRIIPPTTIIOONN
  21.      These routines perform the following matrix-vector operation:
  22.  
  23.           _y <-_a_l_p_h_a _A_x + _b_e_t_a _y
  24.  
  25.      where _a_l_p_h_a and _b_e_t_a are scalars, _x and _y are _n-element vectors, and _A
  26.      is an _n-by-_n symmetric packed matrix.
  27.  
  28.      These routines have the following arguments:
  29.  
  30.      _u_p_l_o      Character*1.  (input)
  31.                Specifies whether the upper or lower triangular part of
  32.                matrix _A is packed into the array argument _a_p, as follows:
  33.  
  34.                _u_p_l_o= 'U' or 'u':  the upper triangular part of _A is being
  35.                supplied in the argument _a_p.
  36.                _u_p_l_o= 'L' or 'l':  the lower triangular part of _A is being
  37.                supplied in the argument _a_p.
  38.  
  39.      _n         Integer.  (input)
  40.                Specifies the order of matrix _A.  _n >= 0.
  41.  
  42.      _a_l_p_h_a     Scalar alpha.  (input)
  43.                SSSSPPMMVV: Real.
  44.                DDSSPPMMVV: Double precision.
  45.  
  46.      _a_p        Array of dimension (_n(_n+1))/2  (input)
  47.                SSSSPPMMVV: Real array.
  48.                DDSSPPMMVV: Double precision array.
  49.  
  50.                Before entry with _u_p_l_o = 'U' or 'u', array _a_p must contain
  51.                the upper triangular part of the symmetric matrix packed
  52.                sequentially, column-by-column, so that _a_p(1) contains
  53.                _A(1,1), _a_p(2) contains _A(1,2), _a_p(3) contains _A(2,2), and so
  54.                on.
  55.  
  56.                Before entry with _u_p_l_o = 'L' or 'l', array _a_p must contain
  57.                the lower triangular part of the symmetric matrix packed
  58.                sequentially, column-by-column, so that _a_p(1) contains
  59.                _A(1,1), _a_p(2) contains _A(2,1), _a_p(3) contains _A(3,1), and so
  60.                on.
  61.  
  62.      _x         Array of dimension 1+(_n-1) * |_i_n_c_x|.  (input)
  63.                SSSSPPMMVV: Real array.
  64.                DDSSPPMMVV: Double precision array.
  65.                Contains vector _x.
  66.  
  67.      _i_n_c_x      Integer.  (input)
  68.                Specifies the increment for the elements of _x.  _i_n_c_x must
  69.                not be 0.
  70.  
  71.      _b_e_t_a      Scalar beta.  (input)
  72.                SSSSPPMMVV: Real.
  73.                DDSSPPMMVV: Double precision.
  74.                If _b_e_t_a is supplied as 0, _y need not be set on input.
  75.  
  76.      _y         Array of dimension 1+(_n-1) * |_i_n_c_y|.  (input and output)
  77.                SSSSPPMMVV: Real array.
  78.                DDSSPPMMVV: Double precision array.
  79.                Contains vector _y.  On exit, the updated vector overwrites
  80.                array _y.
  81.  
  82.      _i_n_c_y      Integer.  (input)
  83.                Specifies the increment for the elements of _y.  _i_n_c_y must
  84.                not be 0.
  85.  
  86. NNOOTTEESS
  87.      SSSSPPMMVV/DDSSPPMMVV is a Level 2 Basic Linear Algebra Subprogram (Level 2
  88.      BLAS).
  89.  
  90.      When working backward (_i_n_c_x < 0 or _i_n_c_y < 0), each routine starts at
  91.      the end of the vector and moves backward, as follows:
  92.  
  93.           _x(1-_i_n_c_x * (_n-1)), _x(1-_i_n_c_x * (_n-2)) , ..., _x(1)
  94.  
  95.           _y(1-_i_n_c_y * (_n-1)), _y(1-_i_n_c_y * (_n-2)) , ..., _y(1)
  96.  
  97. SSEEEE AALLSSOO
  98.      HHPPMMVV(3F)
  99.  
  100.      This man page is available only online.
  101.